Resource URL: /platform/<<version=3>>/auth/providers/nis/<ID>

    Overview: This resource applies the standard collection pattern to
              individual NIS providers.

     Methods: GET, PUT, DELETE

********************************************************************************

Method GET: Retrieve the NIS provider.

       URL: GET /platform/<<version=3>>/auth/providers/nis/<ID>

Query arguments:
scope=<enum> Where <enum> is one of user, default, effective.  If specified as
             "effective" or not specified, all fields are returned.  If
             specified as "user", only fields with non-default values are
             shown.  If specified as "default", the original values are
             returned.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "additionalProperties": false, 
      "type": "object", 
      "properties": {
        "nis": {
          "minItems": 0, 
          "items": {
            "type": "object", 
            "description": "Specifies the properties for an NIS authentication provider.", 
            "properties": {
              "hostname_lookup": {
                "type": "boolean", 
                "description": "If true, enables host name look ups."
              }, 
              "group_domain": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the domain for this provider through which groups are qualified.", 
                "maxLength": 255
              }, 
              "servers": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Adds an NIS server for this provider.", 
                "maxItems": 4294967295
              }, 
              "unlistable_users": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies a user that cannot be listed by the provider.", 
                "maxItems": 4294967295
              }, 
              "normalize_users": {
                "type": "boolean", 
                "description": "Normalizes user names to lowercase before look up."
              }, 
              "id": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the NIS provider ID.", 
                "maxLength": 255
              }, 
              "request_timeout": {
                "minimum": 0, 
                "type": "integer", 
                "description": "Specifies the request timeout interval in seconds.", 
                "maximum": 3600
              }, 
              "provider_domain": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the domain for the provider.", 
                "maxLength": 255
              }, 
              "enumerate_groups": {
                "type": "boolean", 
                "description": "If true, allows the provider to enumerate groups."
              }, 
              "listable_groups": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies the groups that can be viewed in the provider.", 
                "maxItems": 4294967295
              }, 
              "system": {
                "type": "boolean", 
                "description": "If true, indicates that this provider instance was created by OneFS and cannot be removed."
              }, 
              "authentication": {
                "type": "boolean", 
                "description": "If true, enables authentication and identity management through the authentication provider."
              }, 
              "restrict_findable": {
                "type": "boolean", 
                "description": "If true, checks the provider for filtered lists of findable and unfindable users and groups."
              }, 
              "status": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the status of the provider.", 
                "maxLength": 255
              }, 
              "login_shell": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the login shell path.", 
                "maxLength": 4096
              }, 
              "home_directory_template": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the path to the home directory template.", 
                "maxLength": 4096
              }, 
              "findable_users": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies the list of users that can be resolved.", 
                "maxItems": 4294967295
              }, 
              "nis_domain": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the NIS domain name.", 
                "maxLength": 255
              }, 
              "unfindable_groups": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies groups that cannot be resolved by the provider.", 
                "maxItems": 4294967295
              }, 
              "enumerate_users": {
                "type": "boolean", 
                "description": "If true, allows the provider to enumerate users."
              }, 
              "retry_time": {
                "minimum": 0, 
                "type": "integer", 
                "description": "Specifies the timeout period in seconds after which a request will be retried.", 
                "maximum": 3600
              }, 
              "normalize_groups": {
                "type": "boolean", 
                "description": "Normalizes group names to lowercase before look up."
              }, 
              "ypmatch_using_tcp": {
                "type": "boolean", 
                "description": "If true, specifies TCP for YP Match operations."
              }, 
              "user_domain": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the domain for this provider through which users are qualified.", 
                "maxLength": 255
              }, 
              "name": {
                "minLength": 0, 
                "type": "string", 
                "description": "Specifies the NIS provider name.", 
                "maxLength": 255
              }, 
              "listable_users": {
                "minItems": 0, 
                "items": {
                  "minLength": 1, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies the users that can be viewed in the provider.", 
                "maxItems": 4294967295
              }, 
              "unlistable_groups": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies a group that cannot be listed by the provider.", 
                "maxItems": 4294967295
              }, 
              "balance_servers": {
                "type": "boolean", 
                "description": "If true, connects the provider to a random server."
              }, 
              "enabled": {
                "type": "boolean", 
                "description": "If true, enables the NIS provider."
              }, 
              "check_online_interval": {
                "minimum": 0, 
                "type": "integer", 
                "description": "Specifies the time in seconds between provider online checks.", 
                "maximum": 3600
              }, 
              "unfindable_users": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies users that cannot be resolved by the provider.", 
                "maxItems": 4294967295
              }, 
              "findable_groups": {
                "minItems": 0, 
                "items": {
                  "minLength": 0, 
                  "type": "string", 
                  "maxLength": 255
                }, 
                "type": "array", 
                "description": "Specifies the list of groups that can be resolved.", 
                "maxItems": 4294967295
              }, 
              "restrict_listable": {
                "type": "boolean", 
                "description": "If true, checks the provider for filtered lists of listable and unlistable users and groups."
              }, 
              "ntlm_support": {
                "enum": [
                  "all", 
                  "v2only", 
                  "none"
                ], 
                "type": "string", 
                "description": "Specifies which NTLM versions to support for users with NTLM-compatible credentials."
              }, 
              "create_home_directory": {
                "type": "boolean", 
                "description": "Automatically creates the home directory on the first login."
              }
            }
          }, 
          "type": "array", 
          "maxItems": 4294967295
        }
      }
    }
  ]
}

********************************************************************************

Method PUT: Modify the NIS provider.

       URL: PUT /platform/<<version=3>>/auth/providers/nis/<ID>

There are no query arguments for this method.

PUT request body schema:
{
  "type": "object", 
  "description": "Specifies the properties for an NIS authentication provider.", 
  "properties": {
    "hostname_lookup": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, enables host name look ups."
        }
      ]
    }, 
    "group_domain": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minLength": 0, 
          "type": "string", 
          "description": "Specifies the domain for this provider through which groups are qualified.", 
          "maxLength": 255
        }
      ]
    }, 
    "servers": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Adds an NIS server for this provider.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "unlistable_users": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies a user that cannot be listed by the provider.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "normalize_users": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "Normalizes user names to lowercase before look up."
        }
      ]
    }, 
    "request_timeout": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minimum": 0, 
          "type": "integer", 
          "description": "Specifies the request timeout interval in seconds.", 
          "maximum": 3600
        }
      ]
    }, 
    "provider_domain": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minLength": 0, 
          "type": "string", 
          "description": "Specifies the domain for the provider.", 
          "maxLength": 255
        }
      ]
    }, 
    "enumerate_groups": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, allows the provider to enumerate groups."
        }
      ]
    }, 
    "listable_groups": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies the groups that can be viewed in the provider.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "authentication": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, enables authentication and identity management through the authentication provider."
        }
      ]
    }, 
    "restrict_findable": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, checks the provider for filtered lists of findable and unfindable users and groups."
        }
      ]
    }, 
    "login_shell": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minLength": 0, 
          "type": "string", 
          "description": "Specifies the login shell path.", 
          "maxLength": 4096
        }
      ]
    }, 
    "home_directory_template": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minLength": 0, 
          "type": "string", 
          "description": "Specifies the path to the home directory template.", 
          "maxLength": 4096
        }
      ]
    }, 
    "findable_users": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies the list of users that can be resolved.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "nis_domain": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minLength": 0, 
          "type": "string", 
          "description": "Specifies the NIS domain name.", 
          "maxLength": 255
        }
      ]
    }, 
    "unfindable_groups": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies groups that cannot be resolved by the provider.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "enumerate_users": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, allows the provider to enumerate users."
        }
      ]
    }, 
    "retry_time": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minimum": 0, 
          "type": "integer", 
          "description": "Specifies the timeout period in seconds after which a request will be retried.", 
          "maximum": 3600
        }
      ]
    }, 
    "normalize_groups": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "Normalizes group names to lowercase before look up."
        }
      ]
    }, 
    "ypmatch_using_tcp": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, specifies TCP for YP Match operations."
        }
      ]
    }, 
    "user_domain": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minLength": 0, 
          "type": "string", 
          "description": "Specifies the domain for this provider through which users are qualified.", 
          "maxLength": 255
        }
      ]
    }, 
    "name": {
      "minLength": 0, 
      "type": "string", 
      "description": "Specifies the NIS provider name.", 
      "maxLength": 255
    }, 
    "listable_users": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 1, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies the users that can be viewed in the provider.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "unlistable_groups": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies a group that cannot be listed by the provider.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "balance_servers": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, connects the provider to a random server."
        }
      ]
    }, 
    "enabled": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, enables the NIS provider."
        }
      ]
    }, 
    "check_online_interval": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minimum": 0, 
          "type": "integer", 
          "description": "Specifies the time in seconds between provider online checks.", 
          "maximum": 3600
        }
      ]
    }, 
    "unfindable_users": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies users that cannot be resolved by the provider.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "findable_groups": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "minItems": 0, 
          "items": {
            "minLength": 0, 
            "type": "string", 
            "maxLength": 255
          }, 
          "type": "array", 
          "description": "Specifies the list of groups that can be resolved.", 
          "maxItems": 4294967295
        }
      ]
    }, 
    "restrict_listable": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "If true, checks the provider for filtered lists of listable and unlistable users and groups."
        }
      ]
    }, 
    "ntlm_support": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "enum": [
            "all", 
            "v2only", 
            "none"
          ], 
          "type": "string", 
          "description": "Specifies which NTLM versions to support for users with NTLM-compatible credentials."
        }
      ]
    }, 
    "create_home_directory": {
      "type": [
        {
          "enum": [
            "@DEFAULT"
          ], 
          "type": "string"
        }, 
        {
          "type": "boolean", 
          "description": "Automatically creates the home directory on the first login."
        }
      ]
    }
  }
}

There is no JSON response body for this method.

********************************************************************************

Method DELETE: Delete the NIS provider.

          URL: DELETE /platform/<<version=3>>/auth/providers/nis/<ID>

There are no query arguments for this method.

There is no JSON response body for this method.
